QTVREnableHotSpot2

QTVREnableHotSpot

You can use the QTVREnableHotSpot function to enable or disable one or more hot spots.

OSErr QTVREnableHotSpot (
                     QTVRInstance qtvr,
                     UInt32enableFlag,
                     UInt32hotSpotValue,
                     Booleanenable);

qtvr

An instance of a QuickTime VR movie.

enableFlag

The kind of hot spot or hot spots to enable or disable. See "Hot Spot Selectors" for a description of the constants you can pass in this parameter.

hotSpotValue

The desired hot spot or spots, relative to the specified enabled flag. If enableFlag is kQTVRHotSpotID , this parameter specifies a hot spot ID. If enableFlag is kQTVRHotSpotType , this parameter specifies a hot spot type. If enableFlag is kQTVRAllHotSpots , this parameter should be set to zero.

enable

A Boolean value that indicates whether the specified hot spots are to be enabled (true ) or disabled (false ).

function result

A result code.

DESCRIPTION

The QTVREnableHotSpot function either enables or disables the hot spot or spots specified by the enableFlag and hotSpotValue parameters, according to the value of the enable parameter. The hot spots are always selected from among the hot spots in the current node of the QuickTime VR movie specified by the qtvr parameter.

Normally, all hot spots in a node are enabled (that is, the cursor automatically changes shape when it is moved over a hot spot, and the QTVRTriggerHotSpot function is called internally when the user clicks a hot spot). When a hot spot is disabled, QuickTime VR behaves as if the hot spot were not present.